@ledgerhq/errors

Custom Error Definitions

This feature allows you to define custom error classes that extend the built-in TransportError class. This makes it easier to create specific error types for different scenarios.

const { TransportError, StatusCodes } = require('@ledgerhq/errors');

class MyCustomError extends TransportError {
  constructor(message) {
    super(message, StatusCodes.UNKNOWN_ERROR);
    this.name = 'MyCustomError';
  }
}

try {
  throw new MyCustomError('Something went wrong');
} catch (error) {
  console.error(error.name); // MyCustomError
  console.error(error.message); // Something went wrong
  console.error(error.statusCode); // UNKNOWN_ERROR
}

Error Handling

This feature demonstrates how to handle errors thrown by operations, specifically checking if the error is an instance of TransportError and logging the appropriate message and status code.

const { TransportError, StatusCodes } = require('@ledgerhq/errors');

function performOperation() {
  throw new TransportError('Operation failed', StatusCodes.CONDITIONS_OF_USE_NOT_SATISFIED);
}

try {
  performOperation();
} catch (error) {
  if (error instanceof TransportError) {
    console.error(`Error: ${error.message}, Status Code: ${error.statusCode}`);
  } else {
    console.error('An unknown error occurred');
  }
}

Predefined Status Codes

The package provides a set of predefined status codes that can be used to standardize error handling across different parts of your application.

const { StatusCodes } = require('@ledgerhq/errors');

console.log(StatusCodes.CONDITIONS_OF_USE_NOT_SATISFIED); // 0x6985
console.log(StatusCodes.INS_NOT_SUPPORTED); // 0x6D00